<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-gb" lang="en-gb">
<head>
  <meta name="generator" content="Hugo 0.69.0" />

  <meta http-equiv="content-type" content="text/html; charset=utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1">

  <title>Currency</title>

  <link rel="shortcut icon" href="favicon.ico" type="image/x-icon">
  <link href="https://fonts.googleapis.com/css?family=Open+Sans" rel="stylesheet">
  <link rel="stylesheet" href="https://billthefarmer.github.io/currency/css/styles.css">
  <link rel="stylesheet" href="https://billthefarmer.github.io/currency/css/custom.css">
  <link href="/currency/index.xml" rel="alternate" type="application/rss+xml" title="Currency" />

</head>
<body>

<div class="sidebar sidebar-cyan">
  <div class="navigation">
    <div class="logo">
  
    
  <a href="https://github.com/billthefarmer/currency" target="_blank" >
    <img src="images/icon.png"
          style="max-width: 25%"
          />
  </a>
    
  <a href="https://f-droid.org/packages/org.billthefarmer.currency" target="_blank" >
    <img src="https://f-droid.org/wiki/images/c/ca/F-Droid-button_available-on_smaller.png"
          />
  </a>
    
  <a href="https://github.com/billthefarmer/currency/releases" target="_blank" >
    <img src="https://img.shields.io/github/v/release/billthefarmer/currency.svg?logo=github"
          />
  </a>
    
  
</div>

    <h1 class="site-title"><a href="https://billthefarmer.github.io/currency/">Currency</a></h1>


    <nav class="internal">
      <ul>
    
        
            
    <li>
        <a href="#introduction">Introduction</a>
        <ul>
            
                
                    <li><a href="#features">Features</a></li>
                
            
        </ul>
    </li>



        
            
    <li>
        <a href="#using">Using</a>
        <ul>
            
                
                    <li><a href="#edit">Edit</a></li>
                
                    <li><a href="#toolbar">Toolbar</a></li>
                
                    <li><a href="#edit-list">Edit Currency List</a></li>
                
                    <li><a href="#chart">Chart</a></li>
                
            
        </ul>
    </li>



        
            
    <li>
        <a href="#settings">Settings</a>
        <ul>
            
                
                    <li><a href="#settings">Settings</a></li>
                
            
        </ul>
    </li>



        
    
</ul>

    </nav>

    <nav class="external">
      <div class="external-title"></div>
      
    </nav>
  </div>

  <div class="version">
    <p>
  Copyright &copy; 2020 Bill Farmer
</p>

  </div>
</div>

<div class="content">
    
        
            
    <section class="page" id="introduction">
    
    <h1>
        <a href="#introduction">Introduction</a>
    </h1>
    
    <div class="content">
        <p><a href="https://github.com/billthefarmer/currency">Currency</a> is an app for currency conversion and keeping track of
your selection of currencies.</p>
<p><img src="images/currency.png" alt="Currency"> <img src="images/choose.png" alt="Choose"></p>

    </div>
</section>

    
            
                <section class="page" id="features">
    
    <h3>
        <a href="#features">Features</a>
    </h3>
    
    <div class="content">
        <ul>
<li>Currency rates from the <a href="https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html">European Central Bank</a></li>
<li>32 international currencies</li>
<li>Currency rates updated daily</li>
<li>Last rate update retained for use offline</li>
<li>Extra currency for unsupported currencies</li>
<li>Ukrainian, German, Italian, French, Spanish and Indonesian translation</li>
</ul>

    </div>
</section>

            
    



        
            
    <section class="page" id="using">
    
    <h1>
        <a href="#using">Using</a>
    </h1>
    
    <div class="content">
        <p><img src="images/landscape.png" alt="Landscape"></p>

    </div>
</section>

    
            
                <section class="page" id="edit">
    
    <h3>
        <a href="#edit">Edit</a>
    </h3>
    
    <div class="content">
        <p>Touch the current currency value field to edit the value. The display
will be updated dynamically as you type. Touch the <strong>Done</strong> button on
the numeric keypad to update the value field.  The whole value field
is selected by default when touched so it will be overwritten by
typing in a new value. To deselect the text, touch an adjacent area,
like the currency flag.</p>

    </div>
</section>

            
                <section class="page" id="toolbar">
    
    <h3>
        <a href="#toolbar">Toolbar</a>
    </h3>
    
    <div class="content">
        <p>The icons in the toolbar are:</p>
<ul>
<li><strong>Add</strong> a currency to the list. A scrollable list of currencies will
pop up. Touch an entry to add it or touch the <strong>Cancel</strong> button
below the list. Long touch an entry to select it. Once one currency
is selected others may be added or removed from the selection by
touching them. Another long touch on another currency will clear the
list and select the new currency. Touch the <strong>Clear</strong> button to
clear the selection. Touch the <strong>Select</strong> button to add the
selection. The entries will be added to the list in the order
selected.</li>
<li><strong>Refresh</strong> Get the day&rsquo;s currency rates from the <a href="https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html">ECB</a>. The date
shown on the left above the currency list will be updated if new
rates are available. It may show the previous day because the rates
are updated at around 14:15 CET. The status display on the right
above the currency list will show &lsquo;OK&rsquo;, &lsquo;No Connection&rsquo;, &lsquo;No WiFi&rsquo;
or &lsquo;Roaming&rsquo; according to the update settings. It may show &lsquo;Failed&rsquo;
if the connection times out or fails to connect.</li>
<li><strong>Update</strong> Update the currency rate for the extra currency against
the Euro. A dialog will pop up with the current extra currency
rate. Update the value and touch the OK button. The display will
refresh if the extra currency is displayed.</li>
<li><strong>Help</strong> Display help text.</li>
<li><strong>Settings</strong> Display the settings screen.</li>
</ul>

    </div>
</section>

            
                <section class="page" id="edit-list">
    
    <h3>
        <a href="#edit-list">Edit Currency List</a>
    </h3>
    
    <div class="content">
        <p><img src="images/select.png" alt="Select"></p>
<p>Touch a currency entry in the list to make it current. The old current
currency will move to the top of the list. Long touch a currency entry
to select it. Once one currency is selected others may be added or
removed from the selection by touching them. Another long touch on
another currency will clear the list and select the new currency. The
icons in the toolbar will change to:</p>
<ul>
<li><strong>Clear</strong> the selection.</li>
<li><strong>Remove</strong> the selected currencies.</li>
<li><strong>Chart</strong> Display a chart of selected currencies. If one is
selected, the chart will be of the current currency and the selected
currency. If more than one currency is selected the chart will be of
the last two selected currencies.  Selecting the extra currency will
produce a blank chart.</li>
<li><strong>Copy</strong> selection value to clipboard. Only one value will be copied.</li>
</ul>

    </div>
</section>

            
                <section class="page" id="chart">
    
    <h3>
        <a href="#chart">Chart</a>
    </h3>
    
    <div class="content">
        <p><img src="images/chart.png" alt="Chart"></p>
<p>The display shows an interactive chart of the last 90 days of
historical rates from the <a href="https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html">ECB</a>. The chart responds to two finger
pinch and expand gestures and will scroll once expanded. The toolbar
icons from left to right are:</p>
<ul>
<li><strong>Invert</strong> the chart.</li>
<li><strong>New chart</strong> The scrollable list of currencies will pop up. Select
one or two currencies from the list as above to replace the current
currencies in the chart.</li>
<li><strong>Refresh</strong> the chart.</li>
</ul>
<p><img src="images/hist.png" alt="Historical"></p>
<ul>
<li><strong>Historical</strong> The chart will be updated with nearly eighteen years
of historical data currently dating from 1 January 1999. Not all the
currencies go back this far. <strong>Caution</strong> – this will take a
while, depending on the connection, and will download more than 6Mb
of data.</li>
<li><strong>Range</strong> Change the chart range. The chart will show the latest
data, but will scroll back. <strong>Note</strong> – ranges greater than a
quarter will have no effect unless the chart is updated with the
historical data.
<ul>
<li><strong>Week</strong> – One week</li>
<li><strong>Month</strong> – One month</li>
<li><strong>Quarter</strong> – Three months</li>
<li><strong>Year</strong> – One year</li>
<li><strong>5 Years</strong> – 5 Years</li>
<li><strong>Max</strong> – Maximum current range</li>
</ul>
</li>
</ul>

    </div>
</section>

            
    



        
            
    <section class="page" id="settings">
    
    <h1>
        <a href="#settings">Settings</a>
    </h1>
    
    <div class="content">
        <p><img src="images/settings.png" alt="Settings"> <img src="images/about.png" alt="About"></p>

    </div>
</section>

    
            
                <section class="page" id="settings">
    
    <h3>
        <a href="#settings">Settings</a>
    </h3>
    
    <div class="content">
        <h4 id="update">Update</h4>
<ul>
<li><strong>WiFi</strong> Update while connected on WiFi only</li>
<li><strong>Roaming</strong> Update while roaming</li>
</ul>
<h4 id="numbers">Numbers</h4>
<ul>
<li><strong>Fraction digits</strong> Select the number of digits to display after the
decimal point. A popup list of options will be displayed.</li>
</ul>
<h4 id="chart">Chart</h4>
<ul>
<li><strong>Fill</strong> Fill the chart trace.</li>
</ul>
<h4 id="theme">Theme</h4>
<ul>
<li><strong>Dark</strong> Use dark theme</li>
</ul>
<h4 id="about">About</h4>
<ul>
<li><strong>About</strong> Display the version, copyright and licence.</li>
</ul>

    </div>
</section>

            
    



        
    
</div>
</body>
</html>

